home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / rnet108u.zip / RNET.DOC < prev    next >
Text File  |  1992-07-27  |  73KB  |  1,430 lines

  1.  
  2. RNET.DOC                                                                Page 1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.    ╓──────┐ ╓────┐╓─┐ ╓─────┐ ╓─────┐
  10.    ║ ╒══╗ │ ║ ╒╗ │║ │ ║ ╒═══╛ ╚═╗ ╒═╛    Version: 1.08
  11.    ║ └──╜ │ ║ │║ │║ │ ║ └─┐     ║ │      Release: Mon Jul 27 1992
  12.    ║ ╒═╗ ╒╛ ║ │║ │║ │ ║ ╒═╛     ║ │
  13.    ║ │ ║ └┐ ║ │║ └╜ │ ║ └───┐   ║ │      Copyright 1989-92 Robert Vostreys
  14.    ╚═╛ ╚══╛ ╚═╛╚════╛ ╚═════╛   ╚═╛      All Rights Reserved
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.    PCBoard 14.x EchoConference driver for "QWK" packet based EchoNetworks.
  22.  
  23.  
  24.   _____________________________Naming Conventions____________________________
  25.  
  26.   RNet is distributed using the filenaming convention of:  RNETvvvx.zzz.
  27.   VVV refers to the version, such as '106' for version 1.06, '200' for
  28.   version 2.00.  The X refers to a letter code specifying alpha, beta,
  29.   registered, and shareware release versions.  Alpha and beta versions of
  30.   RNet begin at 'A' and continue no further than 'P'.  The registered release
  31.   version is distributed as RNETvvvR.zzz, the shareware release version is
  32.   distributed as RNETvvvU.zzz ('U' for unregistered).  The final ZZZ refers
  33.   to the compression utility extension, which will usually be .ARC or .ZIP or
  34.   whatever.  When referring to this distribution file in the documentation,
  35.   it will usually be referred to as "ZIP file."
  36.  
  37.  
  38.   _____________________________Distribution File_____________________________
  39.  
  40.      The following files should be present within the distribution ZIP file:
  41.  
  42.         RNET.EXE       Main executable program
  43.  
  44.         RNET.DOC       The documentation you are currently reading (RTFM!)
  45.         RNET_REF.DOC   Quick reference for RNet configuration and operation
  46.         REGISTER.DOC   Shareware registration form and information
  47.         CHANGES.vvv    Changes from version to version (history files)
  48.         ECHOS.DOC      Description and information about EchoConferencing
  49.         MESSAGES.DOC   Listing of errors which are not otherwise explained
  50.         RNETCONF.DOC   Information on PCBCONF and PROCONF interfacing
  51.         PCBCONF.EXE    Interface utility for PCBoard CNAMES conferences
  52.         PROCONF.EXE    Interface utility for ProDoor CONFINFO conferences
  53.  
  54.         SAMPLE1.CFG    Sample (verbose) configuration file with comments
  55.         SAMPLE2.CFG    Sample (brief) HOST_ID.CFG configuration file
  56.  
  57.         MAILRUN.BAT    Example BAT for making a host mail transfer
  58.         MAILRUN.SLT    Example Telix SALT for host mail transfers
  59.         PCBLOGIN.SLT   Example Telix SALT to login to host and open maildoor
  60.         LOWMEM.BAT     Example BAT for using external compression
  61.  
  62. RNET.DOC                                                                Page 2
  63.  
  64.   Alpha/Beta versions usually do not include the .DOC files but instead
  65.   include the CHANGES.vvv file for that version.  Please be sure to read this
  66.   file if you are working with an alpha or beta version of RNet!
  67.  
  68.  
  69.   _____________________________Distribution Rules____________________________
  70.  
  71.   Sysops MAY place 'ZIP Comments' on the RNet distribution ZIP file if they
  72.   normally do such with all their download files.
  73.  
  74.   Sysops MAY NOT place additional files (such as 'README.1ST' or 'BBS_AD')
  75.   within the distribution ZIP file nor may they use the PKZIP -AV
  76.   verification stamp.
  77.  
  78.   Distribution of the alpha, beta, and registered versions is restricted to
  79.   those systems with specific permission to distribute such.  Do not
  80.   distribute any version of RNet except the unregistered (RNETxxxU) version!
  81.  
  82.  
  83. RNET.DOC                                                                Page 3
  84.  
  85.  
  86.  
  87.   ___________________________Contacting the Author___________________________
  88.  
  89.   Problems, questions, and suggestions should be directed to Robert Vostreys:
  90.  
  91.      Modem:         Faster-Than-Light BBS
  92.                     Node1: 404-292-8761 [300 to 14400 V32/bis]
  93.                     Node2: 404-299-3930 [300 to 14400 USR HST]
  94.  
  95.      US Mail:       Robert Vostreys, FTL Sysop
  96.                     Post Office Box 2315
  97.                     Stone Mountain, GA  30086-2315
  98.  
  99.      EchoMail:      ILink:     Sysops, MM-RNet, or Admin EchoConferences.
  100.                     SmartNet:  Sysops, MarkMail, or Admin EchoConferences.
  101.                     RIME:      Sysops or Admin EchoConferences (route ->FTL).
  102.                     Atlanta:   AtlSysops or NetLANTA EchoConferences.
  103.                     GEnie:     R.Vostreys
  104.  
  105.  
  106.   _________________________________Shareware_________________________________
  107.  
  108.   Since you have likely read statements under the heading "Shareware" often,
  109.   I'll not bother going into the idea again.  Simply be aware that RNet is
  110.   shareware ($20US suggested), the registered version has some additional
  111.   features, and that the file REGISTER.DOC contains the shareware
  112.   registration form and information.
  113.  
  114.   Any and all registered users may download and operate any later 1.xx
  115.   registered and beta versions of RNet as desired.  The registered and beta
  116.   versions are always available from:
  117.  
  118.                 Faster-Than-Light      404-292-8761 / 299-3930
  119.                 The Right Place<tm>    404-276-2607 / 476-0847
  120.  
  121.  
  122. RNET.DOC                                                                Page 4
  123.  
  124.  
  125.  
  126.   __________________________________Overview_________________________________
  127.  
  128.   RNet is a utility to transfer messages from one BBS to another using the
  129.   QWK packet format.  The transfer/sharing of messages between BBS's is
  130.   commonly referred to as "EchoMail", "NetMail", or "EchoConferencing."  For
  131.   more information on echo network design and the terms used within this
  132.   document, see ECHOS.DOC.
  133.  
  134.   RNet will insert QWK packet messages into your PCBoard 14.x messagebases
  135.   and export new messages in a REP packet for insertion into a host system's
  136.   messagebases.  If you are familiar with the operation of EZ-Reader, Deluxe,
  137.   AmigaReader or similar QWK packet offline readers, most of the terms and
  138.   ideas used here will be familiar.
  139.  
  140.   The actual transfer of QWK/REP packets is left up to you and your choice of
  141.   communications programs.  Canned scripts and programs such as RoboComm will
  142.   work well to automate mail transfers.  A working example of a Telix SALT
  143.   script (MAILRUN.SLT) is included for your use and information.
  144.  
  145.   Usually, RNet is used in a system "event" to process incoming and outgoing
  146.   mail to a network host during the night (when long distance carrier rates
  147.   are lower).  RNet is designed to be extremely dependable, which may
  148.   substitute safety at the expense of speed.
  149.  
  150.   While RNet is for use with PCBoard 14.x (or ProDoor/ProBBS), your host need
  151.   not be running a PCBoard system.  TomCat! is an example of a WildCat! door
  152.   and MarkMail is an example of a PCBoard/ProDoor door.
  153.  
  154.   RNet is designed to be very verbose (both on-screen, error/warning reports,
  155.   report generation options, callerlog reporting in two formats), and even
  156.   shows on the Node Chat display when running.  If something goes wrong or
  157.   if a condition exists(ed) that warrants attention, a log entry will be made
  158.   to ERROR.LOG with any other information you might need.  There are a
  159.   variety of reports and logs that can be produced as desired.
  160.  
  161.  
  162. RNET.DOC                                                                Page 5
  163.  
  164.  
  165.  
  166.   ________________________________Feature List_______________________________
  167.  
  168.   Support for most (all?) QWK packet mail doors that support NetStatus.
  169.  
  170.   Limited to 32,765 conferences _per_ configuration / host QWK packet.
  171.   Limited to 32,765 conferences _per_ CNAMES or CONFINFO file (or create your
  172.   own conference location file (RNETCONF) using a text editor for complete
  173.   control.)
  174.  
  175.   You may have an unlimited number of hosts and configuration files.
  176.  
  177.   Complete multi-node concurrent access to local conferences supported -- you
  178.   will never lose a message due to concurrent messagebase insertions, even if
  179.   running RNet on several nodes concurrently importing into the same
  180.   messagebases.  Includes support for the new PCBoard 14.5 DOS 3.1 record
  181.   locking method.
  182.  
  183.   Support for PCBoard 14.x CNAMES (39 and 65534 conference versions) and
  184.   ProDoor CONFINFO (255 and 2040 conference versions).
  185.  
  186.   Always sends Host Sysop their private (R/O) messages. Always imports
  187.   private messages addressed to the Local Sysop.  This allows you and your
  188.   host to have a private conversation even in public-transfer-only
  189.   conferences/networks.
  190.  
  191.   Support for multiple hosts (using the same messagebases) with or without
  192.   cross echoing as desired.  This is useful for gateway connections between
  193.   two or more networks.
  194.  
  195.   Private (R/O) messages can be passed or limited on a global or conference-
  196.   by-conference basis.
  197.  
  198.   You may choose to honor or ignore the PCBoard 14.x "ECHO" flag.
  199.  
  200.   Completely definable tagline. The registered version of RNet allows you to
  201.   define the ENTIRE tagline (no software "id" involved -- what you define is
  202.   what you get!)
  203.  
  204.   A separate text-editable pointer file is maintained for each host.  Pointer
  205.   files are automatically backed up when a new REP packet is created.
  206.  
  207.   Special "Network Sysop" functions are supported to allow the network
  208.   administration to route very important messages to your MAIN BOARD if
  209.   needing such attention.
  210.  
  211.   Writes logs and pointer files to  the drive/directory where the
  212.   configuration file is found. This allows you to execute RNet from wherever
  213.   is convenient for your particular system configuration.
  214.  
  215.   Local display (processing screen) supports 25/43/50/60 line modes.
  216.  
  217.   Conference usage analysis reports showing activity in network conferences
  218.   and percentage of traffic generated locally.
  219.  
  220.   Message filtering: RNet will expand TABs, strip unneeded spaces, remove
  221.   bells/^S/^X, pack blank lines from taglines, and even decrypt John Hancock
  222.   encrypted taglines if desired.
  223.  
  224. RNET.DOC                                                                Page 6
  225.  
  226.  
  227.  
  228.   Handles and reports bad or corrupted PCBoard messagebases and NDX files.
  229.  
  230.   Automatically builds a pointer file for each host.  If you add a
  231.   conference, you need not reset a pointer as RNet will assume you want to
  232.   start at the high message number.
  233.  
  234.   Intelligent pointer handling.  If a pointer is set to a message lower than
  235.   the lowest message, RNet will reset the pointer to the low message.  If a
  236.   pointer is set above the high message, RNet will reset the pointer to the
  237.   high message.  You may safely change pointers to any value if needed (such
  238.   as to force export of an entire messagebase for a crashed host or to make a
  239.   backup).
  240.  
  241.   Warns you if you receive a conference in a QWK packet that you have not yet
  242.   configured on your end.
  243.  
  244.   Special commandline operations to force RNet to import/export only a single
  245.   specific conference or to "continue" importing in a QWK packet that stopped
  246.   for some reason (such as disk full).  No need to reprocess the entire
  247.   packet insertion!
  248.  
  249.   Automatic appending of messages to the REP packet if a REP packet is found
  250.   present when running an export.  This is can be enabled and is suggested
  251.   since it allows you to continue "building" on a REP even if your host is
  252.   busy or down.
  253.  
  254.   TCANNING of messages to/from specific users.  You can even TCAN messages
  255.   that are "from" a user, but not those "to" that user and/or vice-versa.
  256.  
  257.   Users (and the Sysop for that matter) can "watch" RNet's operation on the
  258.   Node Chat display in PCBoard. RNet looks like a normal "user". The "City"
  259.   display is used to relay what RNet is specifically doing at that time.
  260.  
  261.   Option to delete QWK packets after successful import automatically.  If an
  262.   import is unsuccessful, RNet will leave the QWK packet there for your
  263.   further investigation.
  264.  
  265.   Networks which support NETNEWS type conferences have a much easier time
  266.   with RNet.  RNet can automatically copy messages in special conferences
  267.   (such as Administration level conferences) into a NetNews conference.
  268.   Also, special messages (from a specific name/person, with a specific
  269.   keyword/subject) can be posted in the NetNews and transferred out along the
  270.   Administration level conferences.  This keeps ALL chitchat out of NetNews
  271.   style conferences.
  272.  
  273.   Automatic processing of multiple QWK packets (such as *.QWK, *.QW0,.. up to
  274.   *.QW9).  Useful if using a "pre-built" packet door such as QMail 4.xx which
  275.   may result in your downloading multiple packets for RNet to process.
  276.  
  277.   Automatic import speed determination.  RNet watches what other users are
  278.   doing via the USERNET.DAT file to decide how safe it is to import messages
  279.   quickly or safely.  If someone on another node (even another RNet) is
  280.   entering a message, RNet will flush the DOS directory structure after each
  281.   message for safety in importing messages.  Otherwise, RNet flushes after
  282.   each conference is completed.  SAFETY FIRST!
  283.  
  284.  
  285. RNET.DOC                                                                Page 7
  286.  
  287.  
  288.  
  289.   _________________________________NetStatus_________________________________
  290.  
  291.   NetStatus refers to your having the "permission" of a host system to echo a
  292.   messagebase (or bases).  You might have NetStatus on perhaps only one or
  293.   two conferences of that particular host's conferences -- that is up to the
  294.   discretion of your host.
  295.  
  296.   The host Sysop _must_ enable NetStatus for you before you can transfer any
  297.   messages back and forth!  Usually this is done with your being accepted
  298.   into an echo network such as ILink or SmartNet, or it may simply be that
  299.   you and another sysop wish to echo (transfer) a debate conference between
  300.   your boards.  Your host must enable NetStatus for your user record within
  301.   the maildoor you will be using for echoing messages.
  302.  
  303.   If you do not have NetStatus, RNet will write a log entry to ERROR.LOG and
  304.   skip the conference(s) in question.  If you are setting up for echomail and
  305.   do not yet have NetStatus on the host system, you will not be permitted to
  306.   import messages from the host system.  Exporting of messages with RNet will
  307.   correctly create a REP file, but they will not be accepted on the host
  308.   without NetStatus enabled.
  309.  
  310.  
  311.   _________________________________MailDoors_________________________________
  312.  
  313.   For RNet to process messages to/from a host system your host must support a
  314.   QWK packet format mail door.  This is where you will download QWK packets
  315.   (which contain new messages coming from the host/upper network) and upload
  316.   your REP packets (containing messages from your system/lower network).
  317.  
  318.   Each BBS running a mail door is assigned a HOST_ID.  If your host was, for
  319.   example, "Faster-Than-Light BBS", the assigned HOST_ID might be "FTL".
  320.  
  321.   Ask your host what the HOST_ID is if not obvious from within the mail door.
  322.  
  323.   When you request new messages from your host's mail door, a HOST_ID.QWK
  324.   packet will be constructed with new messages.  Using the above example, the
  325.   packet would be called FTL.QWK.
  326.  
  327.   When RNet collects new messages from your system to be sent up to the host,
  328.   it will create a HOST_ID.REP packet, such as FTL.REP.
  329.  
  330.   Different mail doors support different maximum conferences for echomail.
  331.   These limitations are for the number of conferences the HOST can support,
  332.   not how many conferences you might wish to have.  RNet always supports up
  333.   to 32765 conferences _per_ RNETCONF configuration on your system!  Host
  334.   conference support by door (as of November 1990):
  335.  
  336.       KMail v1.xx      Up to 32765 conferences available on the host system.
  337.       MarkMail v1.xx     '     256       ''          ''          ''
  338.       MarkMail v2.xx     '   32765       ''          ''          ''
  339.       QMail v2.xx        '     128       ''          ''          ''
  340.       QMail v3 & 4.xx    '     256       ''          ''          ''
  341.       QMail v4(beta)     '    2048?      ''          ''          ''
  342.       TomCat! v1.xx      '     256       ''          ''          ''
  343.  
  344.  
  345. RNET.DOC                                                                Page 8
  346.  
  347.  
  348.  
  349.   ______________________________Echo Conferences_____________________________
  350.  
  351.   Echo conferences are the same as any normal conference on your board except
  352.   that the EchoFlag is used/supported.  In PCBSM/PROSM, create a conference
  353.   as normal.  Then, under the field asking about "Echo mail in conference",
  354.   specify YES.  Beyond that single difference, an Echo conference is the same
  355.   as any other (in setup that is).
  356.  
  357.   Be sure you specify enough "Index (NDX) blocks" to handle the inflow of
  358.   network message traffic.  If you pack your messagebases often (daily or
  359.   perhaps weekly), you can probably get away with one or two blocks.  If, on
  360.   the other hand, you want to keep a large number of messages on-hand or if
  361.   the traffic is extremely heavy (as with most debate conferences), you will
  362.   more than likely want to use four or perhaps six blocks.  Larger values
  363.   waste space unless you intend to keep 10,000 messages in a given conference
  364.   concurrently (or if you never pack the messagebases).
  365.  
  366.   Normally, messages entered in an Echo conference will not be echoed (send
  367.   out over the network) without the EchoFlag turned on.  When a user enters a
  368.   message, they will be prompted "Echo this message?"  If they specify YES,
  369.   then the message will be echoed.  If they specify No, then the message will
  370.   remain on the local system only.  Note that this can be overridden with the
  371.   "IGNOREECHO=" keyword in the HOST_ID configuration file.
  372.  
  373.  
  374.   ________________________________Commandline________________________________
  375.  
  376.   RNet needs only simple information on the commandline to operate.  Most of
  377.   the information RNet needs is derived from the HOST_ID.CFG configuration
  378.   file.  You need only tell RNet what kind of operation you want it to do
  379.   (such as IMPORT or EXPORT) and the HOST_ID.
  380.  
  381.      Commandline syntax:  RNET Operation HOST_ID [Param1 Param2]
  382.  
  383.      Operation must be one of:  EXPORT  IMPORT  SET  TOP.
  384.  
  385.   HOST_ID is *required* for all operations.  HOST_ID is specified for what
  386.   configuration, QWK, and REP packet filenames to look for and should not
  387.   contain an extension.  You should contact your Host Sysop to find out what
  388.   the HOST_ID is for your host's system.  Examples of HOST_ID include FTL,
  389.   TRP, EXECNET, CHEERS, HIGHER, and SEMWARE.
  390.  
  391.   Param1 and Param2 are used to specify additional information relating to
  392.   the operation being executed.  Param1, for example, is used to specify the
  393.   conference to use for SET and TOP operations.  See the text under each
  394.   operation for specific usage.
  395.  
  396.   If you neglect to specify an operation RNet will display a help screen to
  397.   remind you of the syntax.  On this screen you will see the copyright
  398.   notice, current version number, credits to Sysops who were helpful in
  399.   implementing or testing that version, and the Alpha, beta, registered, or
  400.   unregistered status.
  401.  
  402.  
  403. RNET.DOC                                                                Page 9
  404.  
  405.  
  406.  
  407.   ___________________________________EXPORT__________________________________
  408.  
  409.      Syntax:  RNET EXPORT HOST_ID [ONLY LocalConf#]
  410.  
  411.   Export instructs RNet to scan your messagebases for new outgoing messages
  412.   to be sent to your host.  Any new messages found will be placed in a
  413.   compressed HOST_ID.REP packet (appending or overwriting, depending on the
  414.   instructions in the HOST_ID.CFG configuration).  You would normally execute
  415.   this operation before calling your host for mail.
  416.  
  417.   If needed, you may specify ONLY and a local conference number which will
  418.   export new messages in the specified conference _only_.
  419.  
  420.   Examples:
  421.  
  422.      RNET EXPORT CHEERS       ;Export new messages for host CHEERS!
  423.      RNET EXPORT TRP          ;Export new messages for host TRP
  424.      RNET EXPORT TRP ONLY 5   ;Export only new messages in local conference 5
  425.  
  426.  
  427.   ___________________________________IMPORT__________________________________
  428.  
  429.      Syntax:  RNET IMPORT HOST_ID [ONLY|SKIPTO LocalConf#]
  430.  
  431.   Import is used to insert new messages from a QWK packet into your local
  432.   messagebases.  RNet will uncompress the HOST_ID.QWK packet(s), verify
  433.   NetStatus, and import the messages it finds.  You would normally execute
  434.   this operation after having downloaded mail from the host.
  435.  
  436.   There are two optional Param1 specifications accepted for the import
  437.   operation: ONLY and SKIPTO.  If either of these are specified you must also
  438.   specify a local conference number (Param2).
  439.  
  440.   ONLY allows you to import host messages in a specified conference.  This is
  441.   very useful for recovering from problems such as a disk full condition or
  442.   similar disaster.
  443.  
  444.   SKIPTO allows you to import host messages in conferences beyond a specified
  445.   local conference.  This is very useful for continuing an aborted import.
  446.   Simply look at the log to find the last imported conference then use that
  447.   local conference number as Param2.   RNet will then "pick up where it left
  448.   off" and continue importing host messages.
  449.  
  450.   Examples:
  451.  
  452.      RNET IMPORT CHEERS       ;Import messages from host CHEERS!
  453.      RNET IMPORT TRP          ;Import messages from host TRP
  454.      RNET IMPORT TRP ONLY 5   ;Import messages destined for conference 5
  455.      RNET IMPORT TRP SKIPTO 5 ;Resume aborted import at conference 5
  456.  
  457.  
  458. RNET.DOC                                                               Page 10
  459.  
  460.  
  461.  
  462.   ____________________________________SET____________________________________
  463.  
  464.      Syntax:  RNET SET HOST_ID LocalConf# PointerValue
  465.               RNET SET HOST_ID LocalConf# MessagesFromTop
  466.  
  467.   Though the host pointer file can be edited with a standard text editor
  468.   (such as QEdit or Edlin), you may change a messagebase pointer with the
  469.   commandline SET operation.  Specify Param1 as the local conference number
  470.   to change, Param2 as the value to change the pointer to.  If Param2 is
  471.   below the lowest numbered message, the lowest message will be used.  If
  472.   Param2 is above the highest message, the highest message number will be
  473.   used.  And finally, if Param2 is a negative value, RNet will use that value
  474.   subtracted from the highest (top) message number.
  475.  
  476.   Examples:
  477.  
  478.      RNET SET FTL 10 99999    ;set conf 10 pointer to high message.
  479.      RNET SET FTL 10 1        ;set conf 10 pointer to low message.
  480.      RNET SET FTL 10 -100     ;set conf 10 pointer to 100 from the top.
  481.  
  482.  
  483.   ____________________________________TOP____________________________________
  484.  
  485.   This works very similarly to the SET operation but has the advantage of
  486.   allowing you to change all the messagebase pointers at once.  If Param1 is
  487.   specified as a local conference number, RNet will reset that conference
  488.   pointer to the high message in that messagebase.  If Param1 is "ALL", RNet
  489.   will reset all conference pointers to the high message in each messagebase.
  490.  
  491.   Examples:
  492.  
  493.      RNET TOP TRP 1           ;set conf 1 pointer to last (top) message.
  494.      RNET TOP TRP ALL         ;set ALL conf pointers to top.
  495.  
  496.  
  497. RNET.DOC                                                               Page 11
  498.  
  499.  
  500.  
  501.   ___________________________Environment Variables___________________________
  502.  
  503.   RNet will look for and make use of the following environment variables.
  504.   Note that none of these environment variables are required, but are simply
  505.   searched for and used if RNet cannot find what it needs elsewhere.
  506.  
  507.   RNET=      Specify the D:\DIR\ where RNet should search for the HOST_ID.CFG
  508.              file.  RNet will first search the default (current) directory.
  509.              To maintain some compatibility with the old QNet 1.xx system,
  510.              RNet will look for the QWIKMAIL= environment if the RNET=
  511.              environment is not found.
  512.  
  513.              Example:  SET RNET=D:\PCB\RNET\
  514.  
  515.   RNETCONF=  Specify the complete D:\DIR\FILENAME that RNet should use for
  516.              its needed conference information (about your board).  If a
  517.              filename is not specified, RNet will use the RNETCONF= value as
  518.              a base drive/directory and search for RNETCONF there.  By
  519.              default, RNet looks for the file RNETCONF in the current
  520.              directory.  Use the RNETCONF= environment if you want RNet to
  521.              look elsewhere and/or if you want it to use a different filename
  522.              for RNETCONF.
  523.  
  524.              Example:  SET RNETCONF=D:\PCB\RNET\
  525.                or      SET RNETCONF=D:\PCB\RNET\RNETCONF.2
  526.  
  527.   TMP=       Specify the D:\DIR\ where RNet should place working files (such
  528.              as the uncompressed QWK and REP packets).  The drive specified
  529.              must have enough space to handle your largest packet.  RNet will
  530.              also look for the TEMP= and QWORKDIR= environment variables, in
  531.              that order.  Note that the HOST_ID configuration keyword
  532.              WORKDIR= takes priority over the environment.  If you wish to
  533.              have RNet use one of these environment variables, neglect to put
  534.              WORKDIR= in the HOST_ID.CFG file.
  535.  
  536.              Example:  SET TMP=Z:\SCRATCH99\
  537.  
  538.   NODE=      The NODE= environment is used to tell RNet what node number it
  539.              is running on so that it can correctly update NODE CHAT and
  540.              CALLERS log.  The value must be from 0 to 99.  If NODE= is
  541.              specified in the HOST_ID.CFG, it takes precedence over the NODE=
  542.              environment.
  543.  
  544.              Example:  SET NODE=1
  545.  
  546.  
  547. RNET.DOC                                                               Page 12
  548.  
  549.  
  550.  
  551.   ____________________________Configuration Files____________________________
  552.  
  553.   For every host you will be echoing from you will need to create a
  554.   configuration [HOST_ID.CFG] file.  You may create as many CFG files as
  555.   desired or even multiple CFG files for each host.
  556.  
  557.   A CFG file is a simple ASCII text file listing keywords and information.
  558.   RNet will parse the HOST_ID.CFG file (HOST_ID being what was given on the
  559.   commandline that specifies the net name of your host system) to get the
  560.   information it needs.
  561.  
  562.   RNet will first check the default directory, then look for a RNET=
  563.   environment variable (specifying a drive:\directory path) to try to find
  564.   the HOST_ID.CFG file.  If it fails to find the CFG file, RNet will abort
  565.   operation reporting "[host] Configuration file not found!"
  566.  
  567.   Configuration files can and should be created with a standard text editor
  568.   such as QEdit or even Edlin.  Blank lines and lines beginning with a
  569.   semi-colon (";") will be ignored.  Each keyword should be specified on a
  570.   separate line and should have no trailing spaces between the keyword itself
  571.   and an equals ("=") sign that should follow.  Please see the example CFG
  572.   files included in this ZIP file for a template to use.
  573.  
  574.   In a future version a Configuration program will be included to ease the
  575.   configuration process.  Meanwhile, it is recommended that you use an
  576.   existing template (example) CFG file to work with -- simply use the DOS
  577.   COPY command to copy/rename a SAMPLE?.CFG to the needed HOST_ID.CFG
  578.   configuration file.
  579.  
  580.   Most keywords have synonym words (SYN) listed in the description.  These
  581.   alternate keywords have the same meaning as the base keyword and may be
  582.   used interchangably.
  583.  
  584.   The minimum keywords needed for any configuration file:
  585.  
  586.      HOSTSYSOP     (the host sysop name)
  587.      SYSOP         (your name)
  588.      HOSTORIGIN    (host system tagline)               [or HTAG0]
  589.      ORIGIN        (your system tagline)               [or TAG0]
  590.      CONF          (one per conference being echoed)   [or CONVERT]
  591.  
  592.   Highly recommended to be included in any configuration file:
  593.  
  594.      REPLYPROCESS  (so you know exactly what to expect)
  595.      WORKDIR       (or allow environment to specify)
  596.      NODE          (or allow environment to specify)
  597.      USERNET       (even if only specifying "NONE")
  598.  
  599.   You might do well using the example HOST_ID.CFG file as a base for creating
  600.   your configuration files.  Simply copy or rename the HOST_ID.CFG file to
  601.   the proper name for your host (replace HOST_ID with the node/netname of the
  602.   host maildoor, such as FTL or TRP, or EXECNET), then edit the file as
  603.   needed.  Remove any excess CONF statements to avoid exporting messages into
  604.   the wrong conferences!
  605.  
  606.  
  607. RNET.DOC                                                               Page 13
  608.  
  609.  
  610.  
  611.   _________________________Keywords: Names and Users_________________________
  612.  
  613.   HOSTSYSOP    Actual name of your host sysop.  This is the name that
  614.                incoming messages addressed to/from "SYSOP" on your host
  615.                systems board will be translated into.
  616.                SYN: HOST_SYSOP
  617.  
  618.   SYSOP        Your name.  Messages addressed to/from "SYSOP" on your system
  619.                will be translated into this name for outgoing messages.
  620.                SYN: LOCAL_SYSOP LOCALSYSOP
  621.  
  622.   MAKESYSOP    YES|NO; Should RNet address incoming mail to "SYSOP"?  If you
  623.                specify YES to this keyword, RNet will translate any incoming
  624.                messages addressed to/from your name into "SYSOP."
  625.                SYN: MAKE_SYSOP
  626.  
  627.   PRIVATEUSER  Up to 25 users may be specified as "private mail users".  Any
  628.                users specified by a PRIVATEUSER= entry in the CFG file will
  629.                be allowed to send private (R/O) messages despite the global
  630.                PRIVATE= setting.  Useful for moderators, hosts, net sysops,
  631.                and administration folks to send private messages up the
  632.                network.  Note that this does not change the settings of your
  633.                host's mail door -- private messages sent from the host are
  634.                controlled by the host.
  635.                SYN: PRIVATE_USER SPECIAL_USER PRIVATE_MAIL SPECIALUSER
  636.  
  637.                Example:  PRIVATEUSER=GEORGE CARLIN
  638.  
  639.   TCAN         You may specify up to 25 names (one full name  per line) which
  640.                RNet should refuse to process.  Any message addressed to/from
  641.                this user will not be imported or exported but instead written
  642.                to TCAN.LOG in the current directory.
  643.                SYN: TRASHCAN TRASH BADUSER BAD_USER
  644.  
  645.   TOCAN        You may specify up to 10 names with the TOCAN keyword (one
  646.                name per occurrence of TOCAN in the CFG file).  If a message
  647.                is addressed TO this name, RNet will refuse to import/export
  648.                it. As with TCAN, the refused messages are written to TCAN.LOG
  649.                for your review.
  650.                SYN: TRASHCAN_TO TO_TCAN
  651.  
  652.   FRCAN        The same as TOCAN except checks the name against the FROM
  653.                field for each message instead of the TO field.
  654.                SYN: TRANSHCAN_FROM FROMTCAN FROM_TCAN
  655.  
  656.  
  657. RNET.DOC                                                               Page 14
  658.  
  659.  
  660.  
  661.   HANDLE       Up to 50 handle/alias translations may be specified.  This
  662.                keyword allows translation of the user name in the TO/FROM
  663.                fields in two ways.  Because there are two forms for this
  664.                keyword it has confused folks in the past.  Hopefully, these
  665.                explanations and examples will help.
  666.  
  667.                Format:   HANDLE=AlwaysFromThis,AlwaysToThis
  668.                Example:  HANDLE=SPARKY,MARK HERRING
  669.  
  670.                    This example will translate "SPARKY" to "MARK HERRING".
  671.                    *Everytime* "SPARKY" is seen in the to/from fields of a
  672.                    message it will be changed into "MARK HERRING".  The name
  673.                    "SPARKY" will basically never appear locally or on the
  674.                    network, as it will *always* be changed to "MARK HERRING".
  675.  
  676.                    During     the name       is changed to
  677.                    ---------  -------------  -------------
  678.                    IMPORT     SPARKY         MARK HERRING
  679.                    IMPORT     MARK HERRING   MARK HERRING
  680.                    EXPORT     SPARKY         MARK HERRING
  681.                    EXPORT     MARK HERRING   MARK HERRING
  682.  
  683.                The second method of name translation allows you to change a
  684.                name one way during import and the other during export.  Thus,
  685.                you can specify how a name appears on your board which is
  686.                different from the way it appears over the network.  Note the
  687.                addition of the asterisk in the following example:
  688.  
  689.                Format:   HANDLE=*ExportAsThis,ImportAsThis
  690.                Example:  HANDLE=*SPARKY,MARK HERRING
  691.  
  692.                    The asterisk is used to signify that you wish the
  693.                    translation to "reverse" when doing an export.  Anytime
  694.                    the name "SPARKY" or "MARK HERRING" is seen during an
  695.                    import, it is changed into "MARK HERRING".  Anytime
  696.                    "SPARKY" or "MARK HERRING" is seen during an export it is
  697.                    instead changed into "SPARKY".
  698.  
  699.                    During     the name       is changed to
  700.                    ---------  -------------  -------------
  701.                    IMPORT     SPARKY         MARK HERRING
  702.                    IMPORT     MARK HERRING   MARK HERRING
  703.                    EXPORT     SPARKY         SPARKY
  704.                    EXPORT     MARK HERRING   SPARKY
  705.  
  706.                    Thus the name "SPARKY" will always appear over the network
  707.                    while the name "MARK HERRING" will always appear on your
  708.                    board.
  709.  
  710.                Use HANDLE=Name1,Name2 when you *always* want 'Name1' to
  711.                be changed into 'Name2'.
  712.  
  713.                Use HANDLE=*Name1,Name2 when you want 'Name1' to appear
  714.                on the network and 'Name2' to appear on your board.
  715.  
  716.                SYN: ALIAS NAME_CHANGE
  717.  
  718. RNET.DOC                                                               Page 15
  719.  
  720.  
  721.  
  722.  
  723.   _____________________________Keywords: Taglines____________________________
  724.  
  725.   Taglines are always forced into a standard format.  Before the first
  726.   tagline that is to appear on a message, a tearline must appear.  A tearline
  727.   is composed of a line with three dashes ("---") optionally followed by
  728.   additional text (FidoNet compatable method).  All taglines follow this
  729.   tearline and begin with either " ■ " or " * ".  RNet will automatically fix
  730.   taglines from other software packages that do not conform to this standard
  731.   and will remove blank lines from between taglines.  RNet will automatically
  732.   chop off any taglines in excess of two.
  733.  
  734.   HOSTORIGIN   Use HOSTORIGIN to specify what tagline to place on messages
  735.                that originate from your HOST system.  The host's mail door
  736.                does not place any taglines on messages, it is up to your end
  737.                of things.  The tagline should conform to whatever network
  738.                standards are currently in effect.  Note that the synonym
  739.                HTAG0 is commonly used instead of HOSTORIGIN.
  740.                SYN: HTAG0 HOST_ORIGIN HOST_TAG HOST_TAGLINE HOSTTAG
  741.  
  742.                Example:  HOSTORIGIN= ■ Host board name ■ City ■ Phone Number
  743.  
  744.   HTAG0..9     The ten HTAGx statements allow you to specify up to ten
  745.                different host taglines.  HTAG0 is the same as HOSTORIGIN and
  746.                may be used in place of it.  To specify which of these ten
  747.                taglines is to be used as the host tagline on any given
  748.                conference, see the CONF statement below.
  749.  
  750.   ORIGIN       ORIGIN is used to specify the tagline to be placed on messages
  751.                coming from your system.  All messages exported from your
  752.                system that originated from your system will have this tagline
  753.                placed on them.  The tagline should conform to the network
  754.                standards of the network in question.
  755.                SYN: TAG0 TAGLINE LOCALTAG LOCAL_TAG
  756.  
  757.                Example:  ORIGIN= * BBS Name, City, Phone Number
  758.  
  759.   TAG0..9      The ten TAGx keywords allow you to specify up to ten different
  760.                taglines for messages originating from your system.  TAG0 is a
  761.                replacement for ORIGIN and can be used in place of it.  To
  762.                specify which of these ten taglines are to be used for each
  763.                specific conference, see the CONF statement.
  764.  
  765.   FORCETAG     YES|NO.  If you specify YES for this keyword, RNet will
  766.                *always* append a tagline (host or origin, as appropriate) on
  767.                all messages processed.  Note that if the tagline addition
  768.                causes more than two taglines to be appended to the message,
  769.                any in excess of two will be stripped.  This is used mostly
  770.                for forcing tagging of messages for debugging use.
  771.                SYN: FORCE_TAG FORCE
  772.  
  773.                Default: NO (disabled; add tagline only when/if needed)
  774.  
  775.  
  776. RNET.DOC                                                               Page 16
  777.  
  778.  
  779.  
  780.   FORCENOTAG   YES|NO.  Specify YES to this keyword if you want to force RNet
  781.                *not* to append any taglines to any messages processed.  In
  782.                smaller and in-company business echo networks, you might
  783.                desire to have no taglines.
  784.                SYN: NOTAG FORCE_NO_TAG
  785.  
  786.                Default: NO (disabled; add tagline if needed)
  787.  
  788.   RTAG         YES|NO|ORIGIN.  The RTAG keyword enables (YES) or disables
  789.                (NO) the " ■ RNet v.vvx: " on the beginning of each tagline.
  790.                If RTAG=ORIGIN is specified, RNet will use the Fido standard
  791.                " * ORIGIN: " at the beginning of the line and append ":RNet
  792.                v.vvx" to the end.  Note that this keyword is subject to
  793.                different effects depending on the version/release of RNet:
  794.  
  795.                  Alpha/Beta: specifying NO changes the tagline id to a
  796.                  shorter id (" ■ Rvvvx:").  This information is used for
  797.                  beta debugging (watching) RNet operate over several large
  798.                  networks where strict control is not possible.
  799.  
  800.                  Unregistered: RTAG=YES and RTAG=NO have no effect.
  801.  
  802.                  Registered: specifying RTAG=NO will completely remove the
  803.                  " ■ RNet" part of the tagline.  In this case, the text you
  804.                  specify for host/origin (HTAGx and TAGx) taglines will be
  805.                  the *complete* text used for the taglines.
  806.  
  807.                SYN: RNETTAG RNET_TAG R_TAG
  808.  
  809.   FIXJH        YES|NO.  This keyword tells RNet if it should automatically
  810.                decrypt encrypted John Hancock version 2.xx taglines.  Some
  811.                networks do not allow encrypted taglines so this option allows
  812.                you to decrypt them automatically.  If you specify FIXJH=YES,
  813.                both incoming and outgoing messages will be checked and
  814.                decrypted.
  815.                SYN: FIX_JH_TAGS
  816.  
  817.                Default: NO (leave encrypted JH taglines alone)
  818.  
  819.  
  820.   ________________________Keywords: Packet Processing________________________
  821.  
  822.   COMPRESS     Specify the program and options needed to compress a REP
  823.                packet for sending to your host.  Check with your host about
  824.                what program/method should be used for packet compression
  825.                (most commonly PKZIP).  All appropriate filenames will be
  826.                added to this command when RNet calls it, so only specify the
  827.                command and switches (if any) needed.  NOTE: If the program
  828.                needed is not in the current directory or along the DOS PATH=
  829.                environment, specify the complete d:\dir\filename.ext.
  830.                SYN: PKPAK ARC PAK PKZIP ZIP
  831.  
  832.                Default:  PKZIP -m -ex
  833.  
  834.  
  835. RNET.DOC                                                               Page 17
  836.  
  837.  
  838.  
  839.   UNCOMPRESS   Specify the command (program) needed to uncompress an incoming
  840.                QWK packet from your host.  Check with your host as to what
  841.                program is needed.  The command must accept placing of a
  842.                directory specification on the end (last parameter) for RNet
  843.                to place the files in the work directory.  If this does not
  844.                work correctly (ie, is not supported by the decompression
  845.                program), you will need to remove all references (CFG and
  846.                environment) to WORKDIR= so RNet uses the current directory.
  847.                SYN: PKUNPAK UNARC UNPAK PKUNZIP UNZIP
  848.  
  849.                Default:  PKUNZIP -o
  850.  
  851.   WORKDIR      Use WORKDIR to specify the drive/directory where RNet should
  852.                place scratch files and uncompressed QWK packets.  If you have
  853.                a large enough RAM drive, specify that.  When RNet is done
  854.                processing, it will only delete the files it created or
  855.                uncompressed, thus, you may even use the current directory
  856.                safely if desired.
  857.  
  858.                Note that the drive/directory pointed to by WORKDIR must
  859.                already exist or RNet will report an error. A recommended
  860.                drive/directory would be the "play" or "scratch" directory
  861.                used by the processing node for up/download processing.
  862.  
  863.                This setting (WORKDIR) overrides the TMP= environment.
  864.  
  865.   REPLYPROCESS APPEND|OVERWRITE.  Specify APPEND for this keyword if you want
  866.                RNet to append new outgoing messages to an existing REP
  867.                packet.  This allows you to keep adding to the end of a REP
  868.                packet when your host has been busy.
  869.  
  870.                *WARNING*: if you use this option, you must delete your
  871.                HOST_ID.REP packet after successful upload to your host.
  872.                Failure to do so will result in uploading duplicate messages!
  873.                SYN: REPLY_PROCESS
  874.  
  875.                Default:  Delete (overwrite) existing HOST_ID.REP packets.
  876.  
  877.   ARCHIVE      The only option for this keyword is EXTERNAL and should only
  878.                be specified if you are prepared to handle it.  If you specify
  879.                ARCHIVE=EXTERNAL, RNet will not shell to DOS to execute the
  880.                COMPRESS and UNCOMPRESS commands, but will instead assume that
  881.                you are going to handle these functions before and after
  882.                calling RNet.  If you are in a tight memory situation, you
  883.                will likely need to use this option.  Please see LOWMEM.BAT
  884.                for more information and an example of how to handle
  885.                compression/decompression in this manner.
  886.  
  887.   QWKPATH      Specify the d:\dir\ where RNet should look for QWK packets
  888.                from your host.  RNet will automatically process multiple
  889.                packets (HOST_ID.QW?) if found, in numerical order.  You
  890.                should use this keyword to point to the download d:\dir\ that
  891.                your terminal communications program downloads QWK packets to.
  892.                SYN: QWK QWKS QWK_PATH QWKPACKETS QWK_PACKETS
  893.  
  894.                Default:  Current drive/directory
  895.  
  896. RNET.DOC                                                               Page 18
  897.  
  898.  
  899.  
  900.   REPPATH      Use this keyword to specify the d:\dir\ where RNet should
  901.                create HOST_ID.REP packets for sending to your host.  Usually
  902.                this will be the d:\dir\ where your terminal program expects
  903.                to find files for uploading.
  904.                SYN: REPLOC REP_PATH REPDIR REP_DIR
  905.  
  906.                Default:  Current drive/directory
  907.  
  908.   KILLQWK      YES|NO.  The KILLQWK keyword allows you to instruct RNet to
  909.                delete the HOST_ID.QWK packets after *successful* import.  If
  910.                anything goes wrong or if RNet has reported any warnings, the
  911.                packet will NOT be deleted.  This can be useful for your event
  912.                batch file to figure out if the import process proceeded
  913.                without any problems simply by looking for the existence of
  914.                *.QW? after import processing.  If *.QW? exists, something
  915.                went wrong.  If you do not use this option, be sure to
  916.                manually delete or move the packet before your next mailrun to
  917.                avoid inserting duplicate messages.
  918.                SYN: KILL_QWK DELETEQWK DELETE_QWK
  919.  
  920.                Default:  NO (QWK packets are not automatically deleted)
  921.  
  922.   CHECKREP     YES|NO.  If you wish, RNet can check for, and prompt you for
  923.                what to do with an existing REP packet (during both IMPORT and
  924.                EXPORT setup operations) when it finds one.  Specify
  925.                CHECKREP=YES to have RNet look for any existing REP packets,
  926.                and if one exists, prompt you to:  Delete the packet and
  927.                continue;  Retain the packet and abort operation; Continue
  928.                normally (default).  RNet will wait for 10 seconds for you to
  929.                make a decision.  This option is available so that if you do
  930.                manual processing of a mailrun, you will be prompted about the
  931.                disposition of any existing REP packets that you may have
  932.                forgotten to manually delete.
  933.                SYN: CHECK_REP
  934.  
  935.                Default:  NO (do not prompt operator for REP disposition)
  936.  
  937.   CKPOINTERS   YES|NO.  By default, RNet will automatically check all its
  938.                current pointers against the existing messagebases (which can
  939.                take a minute or two if you have 2000+ echo conferences).  If
  940.                it finds a problem, it will automatically correct the pointer
  941.                file.  Pointers are checked against the current High and Low
  942.                message numbers in the conference messagebase to determine
  943.                that the pointer is valid.  You may specify CKPOINTERS=NO to
  944.                disable this safety feature (this is *not* recommended!).
  945.                SYN: CHECKPOINTERS CHECK_POINTERS
  946.  
  947.                Default: YES (check all pointers every time RNet is run)
  948.  
  949.  
  950. RNET.DOC                                                               Page 19
  951.  
  952.  
  953.  
  954.   _________________________Keywords: Message Handling________________________
  955.  
  956.   PRIVATE      YES|NO.  This is a global specification as to if private (R/O)
  957.                messages are allowed on the network in question.  If the
  958.                network you are connecting to allows *all* users in *all*
  959.                conferences to send private (R/O) messages, specify
  960.                PRIVATE=YES.  Note that RNet will honor the PCBoard/ProDoor
  961.                conference configuration (PCBSETUP/PROSM) which specifies that
  962.                all messages should be private (R/O) regardless of this
  963.                keyword setting.  Use PRIVATE=NO and PRIVATECONF (see below)
  964.                to specify private messages are allowed only in specific
  965.                conferences.
  966.                SYN: SENDPRIVATE SEND_PRIVATE
  967.  
  968.                Default: NO (send only public messages)
  969.  
  970.   COMMENTS     YES|NO.  This keyword specifies if Sysop COMMENT security
  971.                messages should be exported.  This is useful if you are
  972.                running multiple BBS's and want to send all messages from one
  973.                system to another via RNet.  Note that PRIVATE must be
  974.                specified YES as well for this option to be in effect.
  975.                SYN: SENDCOMMENTS SEND_COMMENTS
  976.  
  977.                Default: NO (do not send COMMENT security messages)
  978.  
  979.   PRIVATECONF  You may specify a list of local conference numbers (separated
  980.                by commas) in which private messages are permitted to be
  981.                transmitted.  This option is added such that you may have a
  982.                network which only allows private (R/O) messages in certain
  983.                conferences.  You may specify as many PRIVATECONF statements
  984.                as needed or desired.  Note that using PRIVATE=YES is the
  985.                global of this keyword.
  986.                SYN: PRIVATE_CONF
  987.  
  988.                Example:  PRIVATECONF=1,10,11,12,200,201
  989.  
  990.   IGNOREECHO   As with PRIVATECONF, you may specify a list of conferences
  991.                (ie, by local conference number) in which you want to ignore
  992.                the PCBoard 14.x EchoFlag status.  This is useful if you have
  993.                an automated process or another mail package that turns off
  994.                the EchoFlag for some reason and you want to export the
  995.                messages despite the EchoFlag.  Normally, RNet will not export
  996.                messages that do not have the EchoFlag specifically enabled on
  997.                them.
  998.                SYN: IGNORE_ECHO
  999.  
  1000.                Example:  IGNOREECHO=5,6,7,10,11,12,200,201
  1001.  
  1002.   ANSICONF     This keyword is used to enable ANSI escape sequences in any
  1003.                given conference(s).  List conferences by local conference
  1004.                number (as with IGNOREECHO above).  RNet will "fix" translated
  1005.                (filtered) ANSI sequences when it can in these conferences.
  1006.                SYN: ANSI ACCEPT_ANSI
  1007.  
  1008. RNET.DOC                                                               Page 20
  1009.  
  1010.  
  1011.  
  1012.   KEYCODE      KEYCODE is used to support multiple or cross echoed networks
  1013.                within the same conferences.  KEYCODE specifies a single
  1014.                character, preferably one of !, @, #, $, %, ^, &, or a single
  1015.                alphanumeric character, which is to be used to specify the
  1016.                network of origin of a message.
  1017.  
  1018.                If you are only echoing a single network or if you are not
  1019.                involved in cross echoing of multiple networks into the same
  1020.                conferences (ie, not a 'gateway'), simply specify KEYCODE=! or
  1021.                something similar (DO NOT USE "*") and ignore the rest of this
  1022.                description.
  1023.  
  1024.                Specify a different KEYCODE for each network you will be
  1025.                echoing.  For example, if echoing ILink, you might specify
  1026.                KEYCODE=I, and for CanConfMail, specify KEYCODE=C.  Doing
  1027.                this, if you echo both networks into the same physical
  1028.                conference, messages from either network will be sent out to
  1029.                the other automatically (along with all replies and messages
  1030.                coming from "lower" on the networks).  This is known as a
  1031.                'Gateway' connection.
  1032.  
  1033.                If you wish to import multiple networks into the same
  1034.                conference and do not want to send the messages from one
  1035.                network to the other, specify the same KEYCODE for both
  1036.                networks (such as KEYCODE=! for in both configurations).  In
  1037.                this case (both KEYCODEs being the same), messages from one
  1038.                network host will *not* be sent to the other while all
  1039.                messages originating from your board (or lower on the
  1040.                network(s)) *will* be exported to both network hosts.  Not
  1041.                likely desired or needed, but the ability is there.
  1042.  
  1043.                Basic logic description:  All messages imported will have the
  1044.                defined KEYCODE assigned to them.  During export processing,
  1045.                any messages that have the exact KEYCODE on them will not be
  1046.                exported (thus avoiding bouncing messages back up the net).
  1047.                Messages sent up to your board from lower on the network will
  1048.                always have a keycode of "*".  If you did not want to send
  1049.                messages from lower on the network up the network (who knows
  1050.                why you would want to do this?!), specify a KEYCODE of "*".
  1051.                SYN: BBSKEY BBS_KEY BBS_KEYCODE
  1052.  
  1053.                Example:  KEYCODE=!
  1054.  
  1055.   ___________________________Keywords: Conferences___________________________
  1056.  
  1057.   CONF         You must specify one CONF statement for every echo conference
  1058.                you are intending to echo with your host.  The CONF keyword is
  1059.                used to specify how your local conference numbers correspond
  1060.                to the host's conference numbers.  You may also use it to
  1061.                specify an alternate tagline to be used for each conference
  1062.                (see HTAG0..9 and TAG0..9 above).  Commonly, the synonym
  1063.                CONVERT is used for CONF.
  1064.  
  1065.                Format:  CONF=Local#,Host#:Tag#
  1066.  
  1067.                Note that the ":Tag#" part of the CONF statement is optional
  1068.  
  1069. RNET.DOC                                                               Page 21
  1070.  
  1071.  
  1072.                and only needed if you wish to specify using taglines other
  1073.                than HTAG0 and TAG0 (see HTAG0..9 above).
  1074.  
  1075.                You may place "comments" after the CONF statement (avoid using
  1076.                a ":" in the comment!) such as listing the conference name.
  1077.                The examples below are valid as they are.  See also the
  1078.                SAMPLE?.CFG files.
  1079.                SYN: CONVERT CONFERENCE
  1080.  
  1081.                Example:  CONF=1,55      (my 1 = host 55, use H/TAG0 tags)
  1082.                Example:  CONF=2,56:0    (my 2 = host 56, use H/TAG0 tags)
  1083.                Example:  CONF=3,60:1    (my 3 = host 60, use H/TAG1 tags)
  1084.                Example:  CONF=4,61:1    (my 4 = host 61, use H/TAG1 tags)
  1085.                Example:  CONF=5,62:1    (Sysops Echo)
  1086.  
  1087.  
  1088.   _____________________________Keywords: NetNews_____________________________
  1089.  
  1090.   NetNews keywords are used to allow a network to support a special "NetNews"
  1091.   type conference that has only special news messages from the network
  1092.   administration.  The philosophy behind the RNet NetNews conference support
  1093.   is to create a conference that is not echoed, but instead has messages
  1094.   inserted in it that come from another conference.  The messages inserted
  1095.   into this special NetNews conference are designated by key words and users
  1096.   as defined by the following keywords.  Ask your network administration if
  1097.   this form of NetNews conference support is available and/or simply monitor
  1098.   the administration conferences and figure out for yourself what "special"
  1099.   messages should be extracted into a special conference (presumably, public
  1100.   for all users to read).
  1101.  
  1102.   All messages imported/exported in the NETADMIN conference are checked.  Any
  1103.   message that is addressed to ALL, addressed from NETADMIN, and the subject
  1104.   contains the text specified by NETSUBJECT, will be copied to the NETNEWS
  1105.   conference as public and non-echo.
  1106.  
  1107.   NETNEWS      Specify the local conference (by number) to be used as the
  1108.                destination for NetNews type messages.  Messages which match
  1109.                the parameters specified by the other keywords will be copied
  1110.                into this conference.  This will commonly NOT be an echo
  1111.                conference and usually has the "Make all messages private"
  1112.                option turned on in PCBSM/PROSM.  RNet will insert messages
  1113.                here as public (despite the "Make private" setting).
  1114.                SYN: NET_NEWS NET_NEWS_CONF
  1115.  
  1116.                Example:  NETNEWS=15     (use local conference 15 for NetNews)
  1117.  
  1118.   NETADMIN     Specify a local conference number that is normally used for
  1119.                Administration level messages.  This conference will be
  1120.                checked during processing for messages that match NETADMINID
  1121.                and NETSUBJECT.  Messages which match the requirements will be
  1122.                copied to the NETNEWS conference.  The original messages will
  1123.                still be imported/exported in this conference so that it is
  1124.                passed to other systems up and down the network.
  1125.                SYN: NET_ADMIN NET_ADMIN_CONF
  1126.  
  1127.                Example:  NETADMIN=44    (search conf 44 for NetNews messages)
  1128.  
  1129.  
  1130. RNET.DOC                                                               Page 22
  1131.  
  1132.  
  1133.   NETADMINID   Use this keyword to specify the name that a message must be
  1134.                FROM to qualify as a NetNews message.  Usually this is either
  1135.                a special alias (such as "Network Administration") or someone
  1136.                in the administration. The message in question must also be
  1137.                addressed to "ALL" to qualify -- this keeps replies and other
  1138.                comments from appearing in the NetNews conference.
  1139.                SYN: NET_ADMIN_ID NETADMIN_NAME NET_ADMIN_NAME
  1140.  
  1141.                Example:  NETADMINID=NETWORK ADMINISTRATION
  1142.  
  1143.   NETSUBJECT   Messages in the NETADMIN conference are checked, and assuming
  1144.                the message matches the NETADMINID the NETSUBJECT is checked.
  1145.                Specify a key phrase or word that must appear in the subject
  1146.                of the message to qualify as a NetNews message.  Usually this
  1147.                is something along the lines of "** ANNOUNCEMENT **".  The
  1148.                subject need not match exactly, but must contain the phrase or
  1149.                words specified with this keyword (which is *not* case
  1150.                sensitive).
  1151.                SYN: NET_SUBJECT
  1152.  
  1153.                Example:  NETSUBJECT=** ANNOUNCEMENT **
  1154.  
  1155.   Logic example:  Using the examples above, if a message appears in local
  1156.   conference 44 (either during import or export processing, so it works even
  1157.   when the message is going "up" the network) is addressed to "ALL", is from
  1158.   "NETWORK ADMINISTRATION" and has the text "** ANNOUNCEMENT **", that
  1159.   message will be copied to local conference 14 as public and non-echo.
  1160.  
  1161.  
  1162.   ________________________Keywords: Multinode/NodeChat_______________________
  1163.  
  1164.   If you are running a multinode system concurrently with your RNet event
  1165.   processing (which is perfectly safe, by the way), you should specify the
  1166.   following keywords to help RNet determine how to proceed.  RNet honors and
  1167.   will check the PCBoard messagebase LOCKED field when inserting messages in
  1168.   all cases.  Assuming you specify these keywords correctly, you may "watch"
  1169.   RNet processing via the NODE CHAT display.
  1170.  
  1171.   NODE         This keyword, when used, will override the environment
  1172.                variable NODE.  If you specify a value of 1-99, RNet will
  1173.                "login" to that node as far as the Node Chat and CALLERS logs'
  1174.                are concerned (see CALLERLOG below).  Specify a value of 0 and
  1175.                USERNET=NONE if running a single node system.  Specify a value
  1176.                of 0 and correctly specify USERNET=d:\dir\usernet.dat to have
  1177.                RNet use the NODE= environment.
  1178.                SYN: PCB_NODE NODE_NUMBER PCBNODE NODENUMBER
  1179.  
  1180.                Example:  NODE=3  (mail events are processed by node 3)
  1181.  
  1182.   USERNET      Specify the d:\dir\filename.ext of the PCBoard node chat
  1183.                USERNET.DAT file.  RNet will show up as a node on the Node
  1184.                Chat display reporting exactly what it is doing (Init,
  1185.                Exporting xxx, Importing xxx, Cleanup, etc) via the city/state
  1186.                field.  RNet must have this keyword specified correctly for
  1187.                its automatic speed selection from fast/slow.  If RNet sees a
  1188.                user on another node who is: Unavailable, Entering a message,
  1189.                or Out of code in door, then RNet will use a slow (safer)
  1190.  
  1191. RNET.DOC                                                               Page 23
  1192.  
  1193.  
  1194.                concurrent message entry routine.  If all users are Available
  1195.                or doing other things, RNet will use a faster insertion
  1196.                routine (it will not flush the directory structure between
  1197.                each message).
  1198.  
  1199.                If running a single node system specify USERNET=NONE.
  1200.                SYN: NETUSER NETUSERS NETDATA NETINFO
  1201.  
  1202.                Example:  USERNET=D:\PCB\MAIN\USERNET.DAT
  1203.  
  1204.   _____________________________Keywords: Reports_____________________________
  1205.  
  1206.   CONFREPORT   Specify the complete d:\dir\filename.ext that RNet should
  1207.                write the conference analysis report to.  This report shows
  1208.                each configured conference, number of messages exported/
  1209.                imported, locally created, percentages comparisons to traffic
  1210.                locally and netwide.  Very handy report to keep around!
  1211.                SYN: CONF_REPORT REPORTFILE REPORT_FILE
  1212.  
  1213.                Example:  CONFREPORT=D:\PCB\GEN\BLT20
  1214.  
  1215.   SUPERLOG     If you want this report, specify a d:\dir\filename.ext for
  1216.                this keyword.  The SUPERLOG (aka ALLMESSAGELOG), is a listing
  1217.                of every message imported or exported by conference, message
  1218.                number, subject, date, addressed to and from.  This log can
  1219.                quickly eat up valuable disk space (similar to the way a
  1220.                CALLERS log can), so don't let it sit around without attention
  1221.                too long.
  1222.                SYN: ALLMESSAGELOG
  1223.  
  1224.                Example:  SUPERLOG=D:\PCB\GEN\ALLMSGS.LOG
  1225.  
  1226.   DAILY        YES|NO.  Enable or disable the daily report analysis logging.
  1227.                RNet will normally create a log report listing each conference
  1228.                and the number of imported/exported messages.  These reports
  1229.                are automatically maintained for the last six days based on
  1230.                the day of the week.  The files created are in the default
  1231.                directory named VERBOSE.XXX where XXX is the day of the week
  1232.                (such as SUN, MON, TUE).  RNet always deletes "tomorrow's"
  1233.                report so that the reports do not consume excess drive space.
  1234.                Specify NO if you want to disable this reporting function.
  1235.                SYN: DAILYLOG DAILY_LOG
  1236.  
  1237.   CALLERLOG    If you want RNet to report the number of messages imported and
  1238.                exported in each conference to the CALLERS log, use CALLERLOG
  1239.                to specify the d:\dir\filename.ext for your CALLERS log file.
  1240.                If you are running a multinode system, do NOT include the node
  1241.                number on the end of the file as RNet will automatically
  1242.                append this.  If running a single node system (ie, NODE=0),
  1243.                RNet will not append a node number to the filename.  RNet will
  1244.                report itself logging in, a baud rate of (Event), Graphics on,
  1245.                and IMPORT or EXPORT for the city/state field.  Next, it will
  1246.                list each conference that has at least one message of traffic
  1247.                in it and the total number of messages imported or exported.
  1248.                Finally, RNet will report the number of minutes used and
  1249.                logoff "normally" (if that is the case).
  1250.                SYN: CALLER_LOG CALLERS
  1251.  
  1252. RNET.DOC                                                               Page 24
  1253.  
  1254.  
  1255.  
  1256.                Example:  CALLERLOG=D:\PCB\MAIN\CALLERS
  1257.  
  1258.   LONGCALLER   YES|NO.  If you specify YES for this keyword, the CALLERLOG
  1259.                report will be much more verbose.  The LONGCALLER report lists
  1260.                every message imported/exported as if a "user" had left the
  1261.                messages in the first place.  This can be useful for caller
  1262.                analysis programs to know exactly how much message traffic is
  1263.                occuring in each conference.
  1264.                SYN: VERBOSECALLERLOG VERBOSE_CALLER_LOG LONG_CALLER_LOG
  1265.  
  1266.                Default: NO (use the short callerlog report format)
  1267.  
  1268.  
  1269.   ____________________________Keywords: Additional___________________________
  1270.  
  1271.   EXTENDED     YES|NO.  This keyword is used to clarify to RNet if your host
  1272.                is using or supporting more than 255 conferences.  This may or
  1273.                may not be needed depending on the mail door you are using on
  1274.                your host.  If you are using MarkMail 2.xx or KMail with
  1275.                conferences numbered higher than 255 on your host (your local
  1276.                conference numbers are not important), you may need to specify
  1277.                EXTENDED=YES to be sure RNet understands.  RNet should be able
  1278.                to determine this for itself, but since there is no agreed-to
  1279.                standard, RNet may need some help figuring it out.
  1280.                SYN: EXTENDED_CONFS EXTENDEDCONFS
  1281.  
  1282.   RUN          You may specify as many RUN statements in your configuration
  1283.                file as desired.  When RNet encounters the RUN keyword in the
  1284.                configuration file, it takes the text following the equals
  1285.                sign and executes a DOS COMMAND.COM/C shell with the command
  1286.                specified.  This is useful if you want to be sure RNet does
  1287.                something every time it is run without having to remember to
  1288.                run a batch file to access RNet.  A common use is to force
  1289.                RNEt to update its RNETCONF file with any changes to your
  1290.                conference setup since the last time it ran.
  1291.  
  1292.                Example: RUN=PCBCONF d:\pcb\main\cnames -i
  1293.                Example: RUN=IF EXIST *.QW? COPY *.QW? D:\HOLDQWKS
  1294.                Example: RUN=MD S:\WORK
  1295.  
  1296.  
  1297. RNET.DOC                                                               Page 25
  1298.  
  1299.  
  1300.  
  1301.   ____________________________Initial Installation___________________________
  1302.  
  1303.   [This assumes that you have already arranged NetStatus with your host BBS
  1304.   and is the most common setup design folks use for RNet.  Additional steps
  1305.   (such as step 5) are added to account for differing situations.]
  1306.  
  1307.    1.  Create a directory for RNet.  Copy all the files from the distribution
  1308.        ZIP into this directory.  Later, you can delete any files you don't
  1309.        need or want (such as the SAMPLE?.CFG files).
  1310.  
  1311.    2.  Run either PCBCONF.EXE or PROCONF.EXE to create the RNETCONF file --
  1312.        RNet will not operate without this file being created.  If running
  1313.        PCBoard 14.x, use PCBCONF.  If running ProDoor 2.9+, use PROCONF.
  1314.  
  1315.          Syntax:  PCBCONF D:\DIR\CNAMES
  1316.          Syntax:  PROCONF D:\DIR\CONFINFO
  1317.  
  1318.    3.  Use a text editor such as QEdit or Edlin to create a HOST_ID.CFG file.
  1319.        If desired, use one of the SAMPLE?.CFG files as a starting point by
  1320.        renaming or copying it to the appropriate HOST_ID.CFG name.
  1321.  
  1322.          Example:  FTL.CFG      (Faster-Than-Light BBS as host)
  1323.          Example:  TRP.CFG      (The Right Place<tm> BBS as host)
  1324.          Example:  EXECNET.CFG  (Executive Network BBS as host)
  1325.  
  1326.        See the documentation above for more information on HOST_ID.CFG files.
  1327.  
  1328.    4.  Run RNet to create a pointer file.  RNet will automatically check
  1329.        the pointers against the messagebases after the pointer file is
  1330.        created.  The TOP operation is selected in case you have another
  1331.        utility you have been using for echomail so that messages will not be
  1332.        lost (see step 5).
  1333.  
  1334.          Syntax:  RNET TOP HOST_ID
  1335.  
  1336.    5.  If you were previously running another echomail utility, run it one
  1337.        last time to export any messages which need to be exported.  This is
  1338.        done _after_ step 4 so that any messages entered on another node
  1339.        between steps 4 and 5 will not be lost.
  1340.  
  1341.        If you were previously running QNet or another QWK packet echomail
  1342.        package, place the newly created REP (if there is one) where you have
  1343.        instructed RNet to look for/create REPs.  Commonly, this is either the
  1344.        RNet directory or the directory where your terminal program expects to
  1345.        find files for uploading.  Assuming you have RNet set to APPEND to
  1346.        REPs (default configuration), RNet will append any new outgoing
  1347.        messages to this REP the next time you run an EXPORT.
  1348.  
  1349.        If you were previously running a non-QWK compatible echomail package,
  1350.        you should upload/send/do-whatever-is-needed the file up to your host
  1351.        -- it might be convenient to do this while handling step 6.
  1352.  
  1353.    6.  Call the host system and configure the mail door.  Open the mail door
  1354.        you will be using for your echomail transfers.  Configure the mail
  1355.        door for the conferences you will be transferring -- set all pointers
  1356.        as appropriate, usually by "topping" all conferences.
  1357.  
  1358. RNET.DOC                                                               Page 26
  1359.  
  1360.  
  1361.  
  1362.        If you were previously using a QWK packet system, you probably need
  1363.        change nothing.  If you have a REP file for upload, you should upload
  1364.        it now.  (If you do upload it, don't forget to delete it!)
  1365.  
  1366.    7.  Download a QWK packet.  You might want to change the pointers on all
  1367.        of the conferences you will be echoing such that you get SOMETHING in
  1368.        every conference.  In other words, set the pointer for each conference
  1369.        to one less than the high message number.  This should result in you
  1370.        getting one message per conference.  Download the QWK to the directory
  1371.        where you have told RNet to expect to find QWK's.
  1372.  
  1373.    8.  Logoff the host, go back to the RNet directory and execute a RNET
  1374.        IMPORT HOST_ID -- this assumes that you did get a QWK packet while in
  1375.        the mail door.  Watch the operation to be sure that nothing is wrong
  1376.        (conferences go where they should, work directory exists, etc).  Make
  1377.        any changes to the HOST_ID.CFG as needed.  After successful IMPORT of
  1378.        the QWK packet, be sure to delete it (if you have KILLQWK=NO).
  1379.  
  1380.    9.  Setup an automated method (suggested) of transferring the mail.
  1381.        Usually this is done via EVENT.SYS and a communications program script
  1382.        or perhaps a package such as RoboComm.
  1383.  
  1384.   10.  If you have any questions or problems, you host will probably have the
  1385.        quickest answers and can help.  If RNet refuses to run or has a
  1386.        problem, it will report (both to the screen and to an ERROR.LOG file)
  1387.        where it is having difficulties.  Check drive & directory entries
  1388.        carefully, as they are the most common problem causing elements.
  1389.  
  1390.        If RNet says: "NetStatus Not Enabled", try adding EXTENDED=YES to your
  1391.        CFG file.  If it still says "NetStatus Not Enabled", you need to call
  1392.        your host to enable NetStatus (some doors don't "believe" the NetStatus
  1393.        until told a couple times... sheesh).
  1394.  
  1395.  
  1396. RNET.DOC                                                               Page 27
  1397.  
  1398.  
  1399.  
  1400.   _________________________Copyrights and Trademarks_________________________
  1401.  
  1402.   All programs mentioned are copyrighted and/or trademarked by their
  1403.   respective holders.  Please refer to each respective program to determine
  1404.   the actual copyright/trademark holder as appropriate or needed.
  1405.  
  1406.  
  1407.   ______________________________Acknowledgments______________________________
  1408.  
  1409.   Roger Sligar -- Sysop of The Right Place<tm> in Atlanta.  He gets top
  1410.                   billing around here for all his support/prodding/effort and
  1411.                   uncountable hours of chasing down bugs/messages across the
  1412.                   world!  It was the desire to safely and dependably run a
  1413.                   couple echo's with TRP that was the invention of RNet.
  1414.  
  1415.   Mark Herring -- Inventor of the QWK format and offline readers/maildoors.
  1416.                   Without his original ideas to bring offline readers to the
  1417.                   PCBoard market, RNet would never have existed.
  1418.  
  1419.   ILink        -- (formally InterLink).  A good international network of good
  1420.                   folks who very quickly adopted RNet into wide use.  It is
  1421.                   for the continued growth of networks like ILink that RNet
  1422.                   is constantly being improved.
  1423.  
  1424.   ... and to the many registered Sysops who are running RNet! -- Thank you for
  1425.   your support and as always, please let me know of any ideas or suggestions
  1426.   you have!  I hope you and your users enjoy the wild and wonderful world of
  1427.   EchoConferences!
  1428.  
  1429.  
  1430.